.TH NODE-L3QD.CONF "5" "September 2023" "node-l3qd daemon config file" "File Formats Manual"
.SH NAME
node-l3qd.conf \- Config file for the l3q node daemon (node-l3qd)
.SH SYNOPSIS
/etc/l3q/node-l3qd.conf
.SH DESCRIPTION
.PP
The node-l3qd.conf is the configuration file for the l3q node daemon. The only and default path to the file is: /etc/l3q/node-l3qd.conf
.br
The config file contains settings for l3q daemon connection over network and l3q node daemon behaviour.
.SH SYNTAX
.PP
The configuration file is written in TOML format.
.br
TOML format files consist of key-value pairs, where keys are strings and values can be one of a number of types.
.br
Keys are always interpreted as strings. Values can be strings, integers, floats, booleans, various types of date-time values, and two special kinds of values called arrays and inline tables.
.br
Everything after a hash symbol to the end of a line is a comment. This doesn't include hash symbols that are part of key or value strings themselves. 
.SH OPTIONS
There are no tables used in this config file only key/value pairs. If variables has been changed the l3q node daemon needs to be restarted to make the chages effective.
.TP
\fBport\fR
.br
Default value: 39911
.br
This is the port that the l3q node daemon (node-l3qd) is listening on. If the l3q node daemon is supposed to use the default port,this variable is not required but to make the l3q node daemon use a different port use this variable to specify the required port.
.TP
\fBdb_file\fR
Default value: /var/lib/l3q/node-l3qd.db
.br
This is the absolute path to the database file used by l3q node daemon. Variable is not required, to use a different location for the database file specify an absolute path. Sqlite3 is used as database and validation data is stored and if l3qd is not reachable the latest task status will be stored until l3qd comes online again.
.TP
\fBl3qd_log\fR
Default value: /var/log/l3q/node-l3qd.log
.br
This is the absolute path to the log file used by l3q node daemon. Variable is not required, to use a different location for the log file specify an absolute path.
.TP
\fBl3qd_port\fR
Default value: 39911
.br
This is the port that the l3q daemon (l3qd) is using for communication. This port it used when the l3q node deamon sends data to the l3q daemon. Only required if a non default port is being used.
.TP
\fBdb_backup_directory\fR
Default value: /var/lib/l3q/backup/
.br
This is the absolute path to the directory where backups of the database is stored. Automatic backups are done every day and a maximum of ten consecutive backups are stored at any time. Only required if a non default directory is being used.
.TP
\fBsystemd_slice_name\fR
Default value:  = l3q.slice
.br
This is the name of the systemd slice that l3q node daemon is using to execute jobs and where the l3q node daemon can limit resources for individual jobs through systemd. To change the slice name more is required then just change the name. A new slice file needs to be created and enabled in systemd to make this change work. Only required if a non default slice name is being used.
.TP
\fBstatus_check_interval\fR
Default value: 60
.br
This value specifies the interval between checks of the latest status on all tasks running on this node. This status is then sent to the central l3q daemon. The unit is seconds and the minimal interval is 10 seconds. Only required if a non default value is being used.
.TP
\fBtask_output_directory\fR
Default value: /var/lib/l3q/task-output
.br
This is the absolute path to where systemd will write all stdout and stderr for all tasks running on this node. All file names will contain both jobid and taskid. Only required if a non default directory is being used.
.SH File:
/etc/l3q/l3qd.conf
.br
.SH AUTHOR
Written by Marcus Pedersén
.SH "REPORTING BUGS"
<https://notabug.org/marcux/l3q>
.SH COPYRIGHT
Copyright \(co 2023 Marcus Pedersén
.br
License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
node-l3qd(8)
